home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / unarced / networking / arn / arn.doc < prev    next >
Text File  |  1995-03-17  |  92KB  |  2,112 lines
  1.  
  2.                                 ___ _____
  3.                               /|   |     \  |\       |
  4.                              / |   |      | | \      |
  5.                             /  |   |      | |  \     |
  6.                            /___|   |_____/  |   \    |
  7.                           /    |   | \      |    \   |
  8.                          /     |   |  \     |     \  |
  9.                         /      |   |   \    |      \ |
  10.                        /       |   |    \___|       \|
  11.                       _________________________________
  12.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  13.  
  14.                           The Amiga-USENET Newsreader
  15.                           (C)opyright by Roland Bless
  16.                                ©/Written 1990-92
  17.  
  18.                                    Version
  19.  
  20.                                 ##     #   #
  21.                                  #    # # # #
  22.                                  #    # # # #
  23.                                 ### #  #   #
  24.  
  25.                                  The Manual
  26.            _______________________________________________________
  27.  
  28.  
  29.                                     Arn.doc
  30.                                       for
  31.                                   VERSION 1.00
  32.                                   ------------
  33.  
  34.   Hint: Find out your current-version-number by typing "Arn -i" to a CLI.
  35.   CHANGES according to earlier versions can be found in the separate file
  36.   'changes'.
  37.  
  38.   +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  39.   + NOTE: Arn has been COMPLETELY redesigned since version 1.00, so read  +
  40.   +       this file completely!! Many answers to questions are given here!+
  41.   +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  42.  
  43.   I N D E X
  44.   ---------
  45.  
  46.   ID: Section:                     Description:
  47.   --------------------------------------------------------------------------
  48.   #1  (C)opyright and Distribution
  49.   #2  Files                        Overview of files that should be enclosed
  50.                                    in this distribution.
  51.   #3  Intro                        What is it? General information about Arn.
  52.   #4  Short info about USENET      Some infos for unexperienced net-users
  53.   #5  Installing Arn
  54.       1. System requirements #5.1
  55.       2. .arnrc              #5.2  The important Arn configuration-file.
  56.       3. Invoking Arn        #5.3  How to start the program,
  57.                                    commandline-options.
  58.   #6  Running Arn                  What Arn normally does after startup.
  59.   #7  Command-Lines                Description of editing command-lines.
  60.   #8  Newsgroup-Selection
  61.   #9  Article-Selection
  62.   #10 The pager                    Arn's internal pager.
  63.       * Display features                      #10.1
  64.       * Basic pager commands                  #10.2
  65.       * Moving to articles in pager           #10.3
  66.       * Posting, replying, forwarding, cancel #10.4
  67.       * Other commands                        #10.5
  68.       * Range commands                        #10.6
  69.   #11 X-Files                      Arn's "kill-files", Autoselection
  70.   #12 REGEXP                       Syntax of regular expressions used by Arn.
  71.   #13 Error-Messages
  72.   #14 Changes according to last version, known bugs
  73.  
  74.   You can jump to these sections by searching for the ID.
  75.  
  76.  
  77. o (C)opyright and Distribution (#1)
  78.   ----------------------------
  79.   This program and its documentation can be freely distributed, but ONLY
  80.   if these rules are followed:
  81.  
  82.   - Commercial usage and making profit with it in any form is strictly
  83.     prohibited, but the program and its documentation may be placed on
  84.     electronic dial-up services for downloading by customers/users of
  85.     such services (like BIX, Compuserve)!
  86.     DISTRIBUTION, except as noted above, IS ONLY ALLOWED AT COST-PRICE/FOR
  87.     NON-PROFIT!
  88.     Fred Fish naturally has the permission to include it in his great
  89.     pool of Amiga Lib(rary) Disks.
  90.  
  91.   - All (C)opyright-notes must be maintained! All rights reserved!
  92.     (C)opyright remains by Roland Bless.
  93.  
  94.   - Redistribution of a changed program and/or documentation is not
  95.     allowed!
  96.  
  97.   - Distribution of this packet/program together with another
  98.     documentation (e.g. translated) is not allowed! This applies esp.
  99.     to German PD-Dealers.
  100.  
  101.   - The redistribution of a changed source without permission of
  102.     the author is strictly prohibited!
  103.  
  104.   - The redistribution in a commercial or PD-mailbox program is not
  105.     allowed without my permission (contact rob@spirits.ka.sub.org).
  106.  
  107.   - I do not take the responsibility for any loss of data or any kind
  108.     of trouble caused by "Arn"!
  109.  
  110.   - This program uses _modified_ V8-regexp (egrep-style) functions
  111.     originally from Henry Spencer, (c) 1986 by University of Toronto.
  112.     The regular expressions are referenced here by REGEXP.
  113.  
  114.   - I do not guarantee that all functions work as described/expected!
  115.  
  116.  
  117.   If you enjoy the program:
  118.   ------------------------
  119.   Please keep always in mind that I spent much (spare-)time in writing this
  120.   software and YOU SHOULD support me with some money of any amount
  121.   (suggested of 20 DM or US $20). My address is:
  122.  
  123.                               Roland Bless
  124.                            Kriegsstrasse 129
  125.                          FRG - 7500 Karlsruhe 1
  126.  
  127.                        (Federal Republic of Germany)
  128.  
  129.   You also can remit it to my bank (for bank account information:
  130.   e-mail, please).
  131.  
  132.   Please redistribute always the files together which come with this
  133.   release. Thanks!
  134.  
  135.   Send any detailed(!) Bug-Reports to (UUCP): bugs@spirits.ka.sub.org
  136.  
  137. o Files (#2)
  138.   -----
  139.   (Alpha releases)
  140.  
  141.   Arn          - the executable/binary
  142.   Arnmaster    - the program to create and update Arn's databases
  143.   Arnhelp.txt  - the help-text for arn.
  144.   Arn.doc      - this documentation
  145.   ArnMaster.doc- additional documentation for arnmaster program.
  146.   changes      - overview of Arn-Versions (release history).
  147.   README.alpha - important announces.
  148.  
  149.   .arnrc       - an example of "Arn"'s configuration file.
  150.   .arnmasterrc - Config-file for the ArnMaster program.
  151.  
  152. o Intro (#3)
  153.   -----
  154.  
  155.   What is it?
  156.  
  157.   "Arn" (AMIGA Reads News) is a program that allows you to read and write a
  158.   lot of news-articles and keeps track of what you already have read or
  159.   not. It is designed for the USENET and follows the rules given by RFC
  160.   1036 (Standard for Interchange of USENET Messages).
  161.  
  162.   Since V1.00 reading news is much more comfortable, because you now
  163.   can individually select articles you want to read by subject and author.
  164.   "Arn" gives you a quick overview where to find 'new' articles and even
  165.   lets you auto-select articles!
  166.   It is now much more like 'nn' and uses databases also. Therefore "Arn"
  167.   and "arnmaster" are now the TWO important programs.
  168.   Arn will definitely not work if you don't use ArnMaster!
  169.  
  170.   It currently doesn't use the mouse, because I think it is better to use
  171.   the keyboard all the time when the task is to read and write many words.
  172.   To switch always from keyboard to mouse (e.g. paging via mouse, writing a
  173.   follow-up with the keyboard) is not rational (IMHO). BUT: It is on my
  174.   "TODO-list" to implement mouse-support.
  175.  
  176.   This newsreader was written from scratch without looking into the real
  177.   "rn" or "nn"-source. Please understand that this version is not yet as
  178.   powerful as its models. It was written in C and I tried my best to
  179.   program it close to the "programming-rules" from Commodore-Amiga. It runs
  180.   under AmigaOS 2.04 and under Kickstart 1.3/1.2 (although you should
  181.   upgrade to 2.0!). If you nevertheless have problems under earlier
  182.   Kickstarts, please report them. If you don't know what a "newsreader" is,
  183.   this is maybe the wrong program for you! But if you want to use or learn
  184.   "UUCP", you should read this manual. "Arn" was originally written for
  185.   Amiga-UUCP, so it will be easy to install it for this UUCP-Version.
  186.  
  187.   ** NOTE: YOU SHOULD UPGRADE YOUR SYSTEM TO AmigaOS 2.04. **
  188.   The time will come where "Arn" uses 2.04 functions!
  189.  
  190.   However, "Arn" was designed to work together with other programs.
  191.   "Arn"'s Configuration-file will allow you to cope with all other
  192.   UUCP-Versions in an easy way.
  193.   It is recommended to use //\\migaUUCP Plus (written by Ingo Feulner)
  194.   an enhancement of the AmigaUUCP V1.06D with CNews. With this package it
  195.   is possible to spool and expire news (real history...). "Arn" uses
  196.   the "active"-file which is supported by AmigaUUCP Plus and created/
  197.   updated by Arnmaster if you specify the -A option. Please excuse my
  198.   horrible English, it isn't my native language.
  199.  
  200.  
  201. o Short information about USENET-Messages (#4)
  202.   ---------------------------------------
  203.   If you want to use this NewsReader, you should be familiar with USENET
  204.   and have some experience. To give a full introduction into USENET is not
  205.   my task...but I'll give some hints for newusers.
  206.  
  207.   I highly recommend to read the newsgroups:
  208.   news.announce.newusers (moderated!) and news.newusers.questions
  209.   as well as
  210.   "How to use USENET effectively" by Matt Bishop.
  211.   It should be available nearly at every site/newsfeed and comes with
  212.   the AmigaUUCP-package.
  213.  
  214.   Some general information about news-articles:
  215.  
  216.   USENET-Messages consist always of a message-header and a message-body.
  217.   The header contains some useful informations for news-transmission as
  218.   well as for the reader (YOU!).
  219.   To continue (long) header-lines, just begin the next line with at least
  220.   one SPACE or TAB (important for long lines your editor wraps around!).
  221.   IMPORTANT:
  222.   THE HEADER IS ALWAYS SEPARATED FROM THE MESSAGE-BODY/TEXT BY AT LEAST
  223.   ONE BLANK LINE! If you're posting articles to the net, please keep always
  224.   in mind that you leave at least one blank line after the header.
  225.  
  226.   Your realname should be visible in the article. If not in the header then
  227.   in your signature. The "signature" normally consists of one or two lines
  228.   containing your realname and E-mail-address and is placed at the end of
  229.   your article ("Arn" will append it for you...).
  230.  
  231.   Some newsgroups are moderated! It is not allowed to post directly to
  232.   these groups (see ACTIVEFILE). Get a list of moderated newsgroups and
  233.   mail to the responsible moderator.
  234.  
  235.   Summary of "How to use USENET effectively" by Matt Bishop:
  236.  
  237.   => Deciding to post
  238.   + Do not repeat postings
  239.   + Do not post anything when upset, angry, or intoxicated
  240.   + Be sure your posting is appropriate to USENET
  241.   + Do not post other people's work without permission
  242.   + Don't forget that opinions are those of the poster and not his company
  243.   => Where to Post
  244.   + Keep the distribution as limited as possible
  245.   + Do not post the same article twice to different groups
  246.   + Do not post to news.announce newsgroups
  247.   + Ask someone if you can't figure  out where to post your article
  248.   + Be sure there is a consensus before creating a new newsgroup
  249.   + Watch out for newsgroups which have special rules about posting
  250.   => Writing the Article
  251.   + Write for your audience
  252.   + Be clear and concise
  253.   + Proofread your article
  254.   + Be extra careful with announcements of products or services
  255.   + Indicate sarcasm and humor
  256.   + Mark postings which spoil surprises
  257.   + Rotate offensive postings
  258.   + The shorter your signature, the better
  259.  
  260.   Please follow these rules!
  261.  
  262. o Installing Arn (#5)
  263.   --------------
  264.  
  265.   1. System requirements (#5.1)
  266.  
  267.   "Arn" should run on all Amiga-Models and requires Kickstart 1.2 or
  268.   higher.
  269.   Since I upgraded to AmigaOS 2.04 and now own a 68030-Card you should
  270.   report problems with compatability and speed (although I'll test Arn in
  271.   68000-Mode). "Arn" normally allocates storage dynamically, so that
  272.   constant values of memory-usage cannot be given. It is quite possible
  273.   that "Arn" requires 100kBytes or more if you're reading newsgroups with
  274.   lots of articles. I DID NOT TEST IT EXPLICITLY ON OTHER AMIGAS! A
  275.   stack-size of 4000 bytes should be sufficient. All memory-allocations are
  276.   checked, so that no crash is caused by insufficient free memory (esp. at
  277.   the "initialization- phase", please let me know any bugs!).
  278.   If it works not well with your configuration (not enough mem, etc.),
  279.   please e-mail.
  280.  
  281.   The NULL:-Device must be installed, if you don't have AmigaOS 2.04.
  282.   Just copy the null-handler to your L: directory and insert the
  283.   mountlist-entry for the null-handler into your Mountlist and "mount
  284.   NULL:".
  285.  
  286.   An Assign for T: and UULIB: should exist. T: is the directory for
  287.   temporary files and UULIB: is required for some "Arn"-Configuration-
  288.   Files. This is typically the UUCP-directory .../usr/lib/uucp (if you have
  289.   AmigaUUCP this assign often already exists...if you followed the docs).
  290.   The file ARNHELP.TXT SHOULD BE MOVED INTO UULIB:!
  291.  
  292.   Examples:
  293.  
  294.   Assign T: RAM:
  295.   Assign UULIB: UUCP:usr/lib/uucp
  296.  
  297.   Last but not least, you must have installed a UUCP-Package such as
  298.   Amiga-UUCP, //\\migaUUCP Plus, Brnews, CNews or JDCP and so on...
  299.  
  300.   The "rot" program is not required by "Arn" (because "Arn" has a built-in
  301.   rot), but I thought that you can maybe use it to encrypt text for writing
  302.   messages.
  303.  
  304.   2. ".arnrc" - "Arn" requires a configuration file! (#5.2)
  305.  
  306.   Don't be worried by the lot of entries here. You won't need them all.
  307.   A file called ".arnrc" must exist in your CURRENT directory or in the
  308.   directory "UULIB:". This file is REQUIRED to configure "Arn". If you
  309.   want to have more than one user using "Arn" just create for each user
  310.   in its home-directory its individual ".arnrc" respectively "UUCONFIG".
  311.   Before entering "Arn" just "cd" into the right home-directory.
  312.  
  313.   An example of ".arnrc":
  314.  
  315.     # Arn Config-File
  316.     # these lines are comments and ignored by Arn
  317.     NEWSDIR     UUNEWS:
  318.     SAVENEWS    UUCP:usr/rob/News
  319.     #ACTIVEFILE UULIB:active
  320.     GROUPLIST   UULIB:.newslib
  321.     UUCONFIG    UULIB:Config
  322.     SEQFILE     UULIB:seq
  323.     SCREENSW    YES
  324.     QUOTECHAR   "> "
  325.     TIMEOFFSET  +0100 GMT
  326.     SIGNATURE   UULIB:.signature
  327.     RELAYVER    version 1.15D (AmigaUUCP)
  328.     POSTINGVER  version 1.15D (AmigaUUCP)
  329.     SENDNEWS    uux %s "%s!rnews"
  330.     SENDMAIL    sendmail <%s -f rob
  331.     #SELFSEND    preprnews %s "rnews "
  332.     SHELLWINDOW Y NEWCON:0/0/640/200/Arn's CLI
  333.     #EXTERNALPRG  Y rx postit %s
  334.     #Set DOTDIRS to Y or YES for Dillon's AmigaUUCP
  335.     #DOTDIRS      Y
  336.     #Alternative reply-address
  337.     #REPLY-TO    fred%nonsens@foovax.bar.com
  338.     #send mail by using a script (archives sent mails)
  339.     #SENDMAIL    sendm %s rob
  340.     #MAILOPTS    From
  341.     #SCREENDATA  640 512 1 Hires-Interlaced
  342.     #PATHTYPE    User
  343.     #FILTER      spellcheck %s
  344.     #XLIFETIME   90
  345.     #CATCHUPXREFS
  346.  
  347.   The format is:
  348.   KEYWORD           VALUE(S)
  349.  
  350.   If "Arn" finds a valid keyword, it will look for the next characters on
  351.   the same line which follow after one or more SPACEs or TABs! The keyword
  352.   is NOT case-dependent but must start in column 0! To set up your own
  353.   configuration-file, make a copy of the example that comes with "Arn" and
  354.   edit it with your favorite ASCII-Editor. The example ".arnrc" should show
  355.   you a typical setup for the Amiga-UUCP-Package.
  356.  
  357.   Each keyword and its function will now be described here:
  358.  
  359.   NEWSDIR
  360.   ~~~~~~~
  361.   After this keyword the PATH to your "News-directory" should follow.
  362.   The "News-Directory" is that one from where all the "newsgroup"-
  363.   directories are branching. For Amiga-UUCP its typically the assign
  364.   "UUNEWS:". The last character should not be a "/" (slash), because "Arn"
  365.   will append one for you!
  366.   examples:
  367.   NEWSDIR  UUNEWS:
  368.   NEWSdir             UUCP:usr/spool/news
  369.  
  370.   DOTDIRS
  371.   ~~~~~~~
  372.   If your newsgroups-hierarchy is of the following form:
  373.   The group comp.sys.amiga.programmers is stored in
  374.   UUNEWS:comp.sys.amiga.programmers
  375.   THEN this KEYWORD should exist and a 'Y' or 'Yes' should be the VALUE!
  376.   The other supported form of directories is
  377.   UUNEWS:comp/sys/amiga/programmers
  378.   which is the default and the DOTDIRS keyword should be deleted from your
  379.   config-file in this case.
  380.  
  381.   SAVENEWS
  382.   ~~~~~~~~
  383.   This is the directory/PATH where your "saved" articles should go. "Arn"
  384.   will use this directory when saving an article with "s" or "w" if no
  385.   other directory is specified (which then must contain a device or a
  386.   colon).
  387.  
  388.   GROUPLIST
  389.   ~~~~~~~~~
  390.   This is the FILENAME which saves informations about read an unread
  391.   articles and newsgroups. Its format is described later in detail. It's
  392.   similar to the ".newsrc" created by "rn". This file will be created for
  393.   you, if it doesn't exist. The old GROUPLIST-file is always renamed to
  394.   GROUPLIST.bak the new one is always named GROUPLIST.
  395.   For those who are manipulating their GROUPLIST with an editor:
  396.   Since V0.68, the entries in GROUPLIST for one newsgroup is unlimited.
  397.   Each list for a newsgroup can be continued by starting the next line
  398.   with one or more white-spaces (spaces/tabs). The length of one line
  399.   will be truncated after 256 characters.
  400.   Because "Arn" normally creates and modifies this list automatically,
  401.   there is no need for you to notice this limit.
  402.  
  403.   ACTIVEFILE
  404.   ~~~~~~~~~~
  405.   This is the FILENAME (with specified path) of your active-file IF YOUR
  406.   UUCP-Version supports it (AmigaUUCP V1.15D currently does not!)!!
  407.   //\\migaUUCP Plus supports this and it's MUCH more comfortable to read
  408.   news with an "active"-file.
  409.   ArnMaster is able to create and update an active-file for you, but
  410.   you have to add new groups manually to your active file yet (see
  411.   Arnmaster.doc for more details).
  412.   "Arn" will read all entries after reading the grouplist. If the group-
  413.   list isn't existent, "Arn" will read your active-file and search for
  414.   new groups to add to the grouplist. This entry activates automatically
  415.   the check for moderated groups. The format of the active-file should be:
  416.  
  417.   groupname xxxxx yyyyy s
  418.  
  419.   groupname is for example comp.sys.amiga, xxxxx is the last article number
  420.   (decimal), yyyyy the number of the first article in this group, s can be
  421.   the single letter "y" or "m" ("Y" or "M", too), where "m" means that this
  422.   group is moderated. Example entries:
  423.   comp.sys.amiga 00345 00101 y
  424.   comp.binaries.amiga 00100 00001 m
  425.  
  426.   The numbers are considered to fit in the "long"-range. Entries in wrong
  427.   format can cause strange errors and crashes..., but normally this file
  428.   can only be changed by your uucp-software (rnews,expire).
  429.  
  430.   UUCONFIG
  431.   ~~~~~~~~
  432.   This is a very important FILENAME for information about the UUCP
  433.   environment. It looks like this (example):
  434.  
  435.        NodeName      spirits
  436.        UserName      rob
  437.        RealName      Roland Bless
  438.        NewsFeed      flatlin
  439.   *    Organization  Byteable Software Products, private, Karlsruhe (FRG)
  440.        MailEditor    Dme
  441.        NewsEditor    Dme
  442.        DomainName    .ka.sub.org
  443.        DefaultNode   flatlin
  444.  
  445.   Entries WITHOUT an asterisk (that is *) are REQUIRED!
  446.   I think these entries are self-explanatory. If you're running Amiga-UUCP
  447.   it is normally called "UULIB:Config". Then you do not have to create it.
  448.  
  449.   SEQFILE
  450.   ~~~~~~~
  451.   This is a FILENAME for a file which should contain a single number in
  452.   ASCII-Format. It will be used for the Message-ID of postings or
  453.   follow-ups and is increased by "Arn". This file exists also under
  454.   Amiga-UUCP as UULIB:seq. The number is set to 0 if it was negative or
  455.   32767.
  456.  
  457.   SCREENSW
  458.   ~~~~~~~~
  459.   Screenswitch. Favourite editors (named in UUCONFIG) can have their own
  460.   screens and therefore you can force "Arn" to switch or not to switch to
  461.   the WorkBench-Screen (bring it to front).
  462.   If something like "NO" follows (only the first letter is important), then
  463.   "Arn" will not bring the WorkBench-Screen to front. If there is a "Yes"
  464.   or anything other than "N", "Arn" will bring the WB-Screen to front.
  465.   After invoking the editor, and after the editor has quit, "Arn" will
  466.   bring always(!) the "ArnScreen" to front. If you still don't know what I
  467.   mean, just let it on "YES".
  468.  
  469.   QUOTECHAR
  470.   ~~~~~~~~~
  471.   This entry contains your favourite character(s) that will be used for
  472.   quoting, that means is inserted in the leftmost column in each line
  473.   of the included text at replies or follow-ups. This entry is LIMITED
  474.   in length! The whole entry should not contain more than 6 characters
  475.   that means 4 characters maximum of QUOTECHAR, because:
  476.   The first char and the last char are stripped off this string just to
  477.   make it possible for including spaces.
  478.  
  479.   examples:
  480.   QUOTECHAR "> "
  481.  
  482.   Quoted text looks like this:
  483.   > this is a test for quotechar. this is a quoted line of text.
  484.   > this is a test for quotechar. this is a quoted line of text.
  485.  
  486.   quotechar    (## |)
  487.  
  488.   Quoted text then looks like this:
  489.   ## |this is a test for quotechar. this is a quoted line of text.
  490.   ## |this is a test for quotechar. this is a quoted line of text.
  491.  
  492.  
  493.   TIMEOFFSET
  494.   ~~~~~~~~~~
  495.   This entry contains two values: A timezone-name and the offset to your
  496.   time concerning this timezone. Example:
  497.  
  498.   TIMEOFFSET +0100 GMT
  499.  
  500.   means that "Arn" will SUBTRACT ONE HOUR from your local time and will
  501.   use/append timezone GMT in Date:-lines.
  502.   Important (since V0.66):
  503.   The format of the time offset is [+|-]hhmm, where hh is the number of
  504.   hours and mm ist the number of minutes (0-60).
  505.  
  506.   Example: You're 9.5 (nine a half) hours before GMT so your
  507.            factor will be 930 (nine hours and thirty minutes):
  508.            TIMEOFFSET +0930 GMT
  509.   To get your local timezone, just write an offset of 0 to the TIMEOFFSET
  510.   then your local-timezone-name after it.
  511.  
  512.   TIMEoffset 0 MET
  513.  
  514.   (MET means Middle-European-Time)
  515.   The value can be preceeded by a minus or a plus sign. If no sign is given
  516.   a plus is assumed (which means to SUBTRACT that value from your local
  517.   time!). Spaces between the signs and the numbers are not allowed!
  518.   Leading zeros are NOT required and can be omitted.
  519.  
  520.   It is recommended to use your offset to GMT (Greenwich-Mean-Time) and
  521.   timeoffset -0100 GMT means that your time is 1 hour BEHIND GMT.
  522.   The length of the TIMEZONE-name is limited to 5 characters! If it is
  523.   missing too long, "Arn" will display a WARNING and say that it took GMT
  524.   instead!
  525.  
  526.   SIGNATURE
  527.   ~~~~~~~~~
  528.   The FILENAME of your signature file to append to your articles/mails
  529.   written with "Arn". "Arn" will NOT put any characters (e.g. the "--")
  530.   before your signature-text. But if you want this, just insert it in your
  531.   SIGNATURE-file...
  532.  
  533.   RELAYVER and POSTINGVER
  534.   ~~~~~~~~     ~~~~~~~~~~
  535.   These two lines are required by RFC 1036 (quoting):
  536.  
  537.   RFC1036|    be passed through unchanged.   The  required  headers  are
  538.   RFC1036|    Relay-Version,  Posting-Version,  From,  Date, Newsgroups,
  539.   RFC1036|    Subject,  Message-ID,  Path.   The  optional  headers  are
  540.   RFC1036|    Followup-To,  Date-Received,  Expires,  Reply-To,  Sender,
  541.   RFC1036|    References, Control, Distribution, Organization.
  542.   RFC1036|
  543.   RFC1036|    2.1  Required Headers
  544.   RFC1036|
  545.   RFC1036|    2.1.1  Relay-Version
  546.   RFC1036|
  547.   RFC1036|                          This header line shows  the  version
  548.   RFC1036|    of  the  program  responsible for the transmission of this
  549.   RFC1036|    article over the immediate link, that is, the program that
  550.   RFC1036|    is  relaying the article from the next site.  For example,
  551.   RFC1036|    suppose site A sends an article to  site  B,  and  site  B
  552.   RFC1036|    forwards  the  article  to  site  C.   The  message  being
  553.   RFC1036|    transmitted from A to B would have a Relay-Version  header
  554.   RFC1036|    identifying  the  program  running  on  A, and the message
  555.   RFC1036|    transmitted from B to C would identify the program running
  556.   RFC1036|    on  B.  This header can be used to interpret older headers
  557.   RFC1036|    in an upward compatible way.  Relay-Version must always be
  558.   RFC1036|    the  first  in  a message; thus, all articles meeting this
  559.   RFC1036|    standard will begin with an upper case  ``R''.   No  other
  560.   RFC1036|    restrictions are placed on the order of header lines.
  561.   RFC1036|
  562.   RFC1036|    The line contains two  fields,  separated  by  semicolons.
  563.   RFC1036|    The fields are the version and the full domain name of the
  564.   RFC1036|    site.  The version should identify the system program used
  565.   RFC1036|    (e.g.,  ``B'')  as  well  as  a version number and version
  566.   RFC1036|    date.  For example, the header line might contain
  567.   RFC1036|
  568.   RFC1036|         Relay-Version: version B 2.10 2/13/83; site cbosgd.UUCP
  569.   RFC1036|
  570.   RFC1036|    This header should not be passed on to  additional  sites.
  571.   RFC1036|    A  relay  program,  when  passing  an  article  on, should
  572.   RFC1036|    include only its own Relay-Version, not the  Relay-Version
  573.   RFC1036|    of  some other site.  (For upward compatibility with older
  574.   RFC1036|    software, if a Relay-Version is found in a header which is
  575.   RFC1036|    not the first line, it should be assumed to be moved by an
  576.   RFC1036|    older version of news and deleted.)
  577.   RFC1036|
  578.   RFC1036|    2.1.2  Posting-Version
  579.   RFC1036|                              This   header   identifies   the
  580.   RFC1036|    software  responsible  for  entering this message into the
  581.   RFC1036|    network.  It has the same  format  as  Relay-Version.   It
  582.   RFC1036|    will  normally  identify  the same site as the Message-ID,
  583.   RFC1036|    unless the posting site is serving  as  a  gateway  for  a
  584.   RFC1036|    message  that  already  contains a message ID generated by
  585.   RFC1036|    mail.  (While it is permissible for a gateway  to  use  an
  586.   RFC1036|    externally  generated message ID, the message ID should be
  587.   RFC1036|    checked to ensure it conforms to this standard and to  RFC
  588.   RFC1036|    822.)
  589.  
  590.   The "; site sitename.domainname" will be automatically added by "Arn".
  591.  
  592.   SENDNEWS
  593.   ~~~~~~~~
  594.   This is the command "Arn" invokes, if you want to post an article to
  595.   the net, that means to send it to your newsfeed(s)/other sites. In
  596.   detail, the article should be spooled in your spool-directory (UUSPOOL:
  597.   with AmigaUUCP) with the necessary control-file(s) for your "uucico".
  598.   It is IMPORTANT THAT THIS LINE CONTAINS two placeholders %s!!!
  599.   It MUST BE "%s" (but without the quotation marks)!
  600.   The first placeholder stands for the internal temporary article-name,
  601.   the second for the NewsFeed-Name.
  602.  
  603.   For older AmigaUUCP versions (<=V1.06D) the line then looks like
  604.   this: SENDNEWS    uux %s "%s!rnews"
  605.  
  606.   If you don't need the second placeholder, then can ignore it with a
  607.   semicolon (entry for //\\migaUUCP Plus):
  608.   SENDNEWS      relaynews <%s -i ; %s
  609.  
  610.   (No guarantuee for dropping the second %s...I think it works...)
  611.  
  612.   or you should create a shell- script (with the +s flag set)
  613.   removing the second "%s" by ignoring it:
  614.  
  615.   dummy.script:
  616.  
  617.   .key artname/a,realname/a
  618.   .bra {
  619.   .ket }
  620.   .dot ~
  621.  
  622.   ; Now invoke the program for spooling-news with {artname} only!
  623.   postit {artname}
  624.  
  625.   Your SENDNEWS is then: SENDNEWS       dummy.script %s %s
  626.  
  627.   For AmigaUUCP V1.08D (and beyond) the line is:
  628.   SENDNEWS preprnews %s "rnews " ;%s
  629.  
  630.   for discription of "preprnews" look at SELFSEND.
  631.  
  632.   SENDMAIL
  633.   ~~~~~~~~
  634.   This is the program which spools the mail for your mailfeed/sites.
  635.   Normally it would be "mail <%s", with AmigaUUCP it is
  636.   "sendmail <%s -f user". Only one %s is required for the filename of the
  637.   article. If your mail doesn't generate the "From:" line, insert the
  638.   MAILOPTS entry in .arnrc. At normal AmigaUUCP (Dillon-Release) the
  639.   sendmail always appends a real-name, if already there or not.
  640.  
  641.   If your mailer requires other informations, which "Arn" doesn't give, do
  642.   it with a script-file! (Note: The script bit should/must be set...) Like
  643.   this to append outgoing mails to a mail.sent-file (dmail gives you the
  644.   possibility: "set archive uumail:mail.sent")
  645.   sendm:
  646.  
  647.   .key mailfile/a,username/a
  648.   .bra {
  649.   .ket }
  650.   .dot ~
  651.   IF exists "{mailfile}"
  652.    type >>UUMAIL:mail.sent {mailfile}
  653.    sendmail <{mailfile} -f "{username}"
  654.   ELSE
  655.    echo "{mailfile} not found!"
  656.   ENDIF
  657.  
  658.   SENDMAIL      sendm %s rob
  659.   then would be the right entry in ".arnrc".
  660.   NOTE: If you don't explicitly specify a PATH before the script-name, the
  661.         script-file must be put in a directory of your "PATH". The best is
  662.         to put it in the same directory where all your other UUCP-commands
  663.         are placed (e.g. UUCP:c).
  664.  
  665.   Sample script for a missing From:-line:
  666.   .key mailfile/a
  667.   .bra {
  668.   .ket }
  669.   .dot ~
  670.   IF exists "{mailfile}"
  671.    echo >T:MYTMP "From: fred@foobar.UUCP"
  672.    type >>T:MYTMP "{mailfile}"
  673.    sendmail <T:MYTMP
  674.   ELSE
  675.    echo "{mailfile} not found!"
  676.   ENDIF
  677.  
  678.  
  679.   MAILOPTS (formerly FROMLINE)
  680.   ~~~~~~~~
  681.   This entry knows two values.
  682.   If there is an "F" or "From" in this line, "Arn" automatically generates
  683.   a "From:"-line at replies.
  684.   If there is a "D" or "Date", the same happens with Date:
  685.  
  686.   Examples:
  687.   MAILOPTS F D
  688.   MAILOPTS From
  689.   MAILOPTS Date From
  690.  
  691.  
  692.   SELFSEND (formerly RNEWS)
  693.   ~~~~~~~~
  694.   This is the program that sorts in the article(s) for YOUR system.
  695.   This entry is NOT required if your SENDNEWS-program "rnews" already sorts
  696.   posted articles into your newsgroups in UUNEWS:. (e.g. //\\migaUUCP Plus
  697.   and AmigaUUCP V1.08D (and beyond), CNews).
  698.  
  699.   If you write an article, older versions of AmigaUUCP (<=V1.06D) e.g. send
  700.   it off, but this article is not sent into YOUR newsgroups. Normally the
  701.   SENDNEWS-program (rnews) should do this for you, but if it doesn't, take
  702.   "preprnews" and "rnews". preprnews is a little program from me (not in
  703.   the V1.00 alpha distributions included since V1.15 of AmigaUUCP doesn't
  704.   require it any longer).
  705.   usage: preprnews articlename progname
  706.   example: preprnews T:tmpfoobar "rnews <"
  707.  
  708.    description:
  709.    preprnews reads the article named "articlename" and cuts off the
  710.    "Relay-Version:"/"Posting-Version:" lines, adds the "#! rnews XXXX"
  711.    line and passes this new file (T:TMPXXXXXX) to the program "progname".
  712.    Then the new (tmp)file is deleted.
  713.  
  714.   Your entry for AmigaUUCP Versions older than V1.08D should look like this
  715.   SELFSEND       preprnews %s "rnews "
  716.  
  717.   The SELFSEND-program is invoked after SENDNEWS was executed.
  718.  
  719.   However: this entry is not required and if your SENDNEWS sorts/sends
  720.   articles at your system in your newsgroups, just forget this entry.
  721.  
  722.  
  723.   SHELLWINDOW
  724.   ~~~~~~~~~~~
  725.   This entry is for the piping commands "S","W" and "|".
  726.   The format is: WBenchToFront WindowSpecifications
  727.   WBenchToFront is either "Y" or "N": N means to bring the
  728.   WorkBench-Screen NOT into front, all other values do.
  729.  
  730.   This entry is optional, because "Arn" has a default entry for it:
  731.   Y CON:0/0/640/200/Arn-CLI
  732.  
  733.   But you can take advantage of your favourite console-handler:
  734.   Y MYCON:0/0/640/200/This is a console window raised by Arn
  735.  
  736.   MYCON: is an example for a custom CON: device.
  737.   As you will see, spaces are preserved, the whole string is copied until
  738.   end of line.
  739.  
  740.   Normally, the CON:-Window will appear on the Workbench-Screen!
  741.   To get rid of this CON:-Window, enter "endcli" at the CLI-prompt.
  742.  
  743.   You can naturally describe here a normal file-name, because "Arn" just
  744.   makes an filehandle= Open(SHELLWINDOW,MODE_NEWFILE) and then an
  745.   Execute(cmd,filehandle,filehandle).
  746.  
  747.  
  748.   EXTERNALPRG
  749.   ~~~~~~~~~~~
  750.   This optional(!) entry specifies an external program to be invoked if you
  751.   type "o" (other) at the pager/article selector.
  752.   The FIRST value must be a character "Y" or "N" to enable/disable the
  753.   SHELLWINDOW during execution of the external program.
  754.  
  755.   A "N" or "n" will NOT open the SHELLWINDOW, all other values will.
  756.   There is a difference between "n" and "N":
  757.   "N" will switch WorkBenchScreen to front, "n" won't!
  758.   For the specification of SHELLWINDOWs see above. If you enable the
  759.   SHELLWINDOW, but the SHELLWINDOW entry is missing, "Arn" takes its
  760.   internal default. After one or more (white) spaces follows the next
  761.   value: A command containing a %s as placeholder for the full-pathname to
  762.   the article. The %s MUST BE PRESENT! Spaces are preserved, the whole
  763.   command-string is copied until end of line.
  764.  
  765.   sample-entry:
  766.   EXTERNALPRG       Y   rx postit %s
  767.  
  768.   This function was implemented on request of the "Software Brewery".
  769.   They released a package - written in ARexx - to post and spool news
  770.   (postit and brnews).
  771.  
  772.  
  773.   FILTER
  774.   ~~~~~~
  775.   Program or script to run over your article you wrote, before posting it.
  776.   This enables you for example to use a spell checker etc..
  777.   The only parameter %s required is the current temporary articlename.
  778.   Example: FILTER  checkarticle %s
  779.  
  780.  
  781.   SCREENDATA
  782.   ~~~~~~~~~~
  783.   This entry supports user defined screens (not for inexperienced users!)
  784.   and is NOT REQUIRED, but optional. It is provided to let flicker-fixer
  785.   or A-3000 users read their news with more lines than normally, because
  786.   the pager uses the full width and height of your screen.
  787.   "Arn" normally opens a "custom-screen" with your default WorkBench-
  788.   resolution and settings, except a two coloured (B/W-1 Bitplane) Screen
  789.   for faster scrolling.
  790.  
  791.   (This feature was suggested by Henrik Clausen, thanks!).
  792.   If this keyword exists, you must specify at least three keywords:
  793.   SCREENDATA width height depth ViewModes
  794.  
  795.   "width" and "height" are the ArnScreen dimensions, "depth" is the number
  796.   of desired Bitplanes, all in DECIMAL format (short integer, i.e. 16-bit).
  797.   ViewModes are the following supported modes:
  798.  
  799.   [NTSC:PAL][Lores|Hires|SuperHires|Productivity]|[-]Interlaced |
  800.   [A2024_10Hz|A2024_15Hz]
  801.  
  802.   That are: Lores, Hires, SuperHires, Interlaced, Lores-Interlaced,
  803.   Hires-Interlaced, NTSC:Lores, NTSC:Hires, NTSC:SuperHires,
  804.   NTSC:Lores-Interlaced, NTSC:Hires-Interlaced, NTSC:SuperHires-Interlaced,
  805.   PAL:Lores, PAL:Hires PAL:SuperHires, PAL:Lores-Interlaced,
  806.   PAL:Hires-Interlaced, PAL:SuperHires-Interlaced, Productivity,
  807.   Productivity-Interlaced, A2024_10Hz, A2024_15Hz.
  808.  
  809.   Monitor modes: only available under OS2.0. If no monitor mode is specified
  810.   you'll get the system default monitor mode (PAL or NTSC).
  811.   Note that you cannot abbreviate these keywords (not laced for Interlaced),
  812.   but they are not case sensitive.
  813.  
  814.   To get the Modes that are not listed here you can specify the mode with
  815.   the IDNUM: keyword:
  816.   IDNUM:0x8004
  817.   is equivalent to Hires-Interlaced for example. Under OS2.04 all modes
  818.   are checked whether they are valid or not, but you should be careful
  819.   under Kickstart 1.3 or earlier. However, this option should be used with
  820.   care.
  821.  
  822.  
  823.   COLORS
  824.   ~~~~~~
  825.   You can specify your own colors for Arn's screen. The number of values
  826.   should match with the 2^(number of bitplanes). The existence of this
  827.   keyword is independent of SCREENDATA.
  828.   (This was contributed by H. Schmiedehausen, thanks.)
  829.  
  830.   Example: COLORS 0x777 0x000 0xFFF 0xDD0
  831.  
  832.   for 2 Bitplanes = 2^2=4 Colors
  833.  
  834.  
  835.   PATHTYPE
  836.   ~~~~~~~~
  837.   This optional entry determines how "Arn" generates a Path:-line for
  838.   new-articles:
  839.   PATHTYPE User
  840.   means that "Arn" generates the line "Path: user".
  841.   PATHTYPE No
  842.   means that "Arn" generates no Path:-line at all.
  843.   PATHTYPE Domain
  844.   means that "Arn" generates a Path:-line with the full-domain systemname
  845.   (Path: system.domain.topdom!user)
  846.  
  847.   all other keywords specify a full Path:-line: "Path: system!user".
  848.  
  849.   This entry was necessary, because AmigaUUCP V1.08D doesn't check anymore
  850.   (for some odd reason), whether the system is already in path:-line or not
  851.   (not good!), so it doubles the system entry.
  852.   However, for AmigaUUCP Versions >=1.08D this entry should be:
  853.   PATHTYPE User
  854.  
  855.  
  856.   XLIFETIME
  857.   ~~~~~~~~~
  858.   This optional entry specifies the default lifetime in days of your X-file
  859.   (see 'X-files') entries, if you add automatically entries to X-files (not
  860.   with your editor). If this entry is missing the XLIFETIME is set to 30
  861.   days.
  862.  
  863.  
  864.   CATCHUPXREFS
  865.   ~~~~~~~~~~~~
  866.   If this keyword exists (no value required) "Arn" marks cross-postings if
  867.   you catchup a group. Because checking for cross-postings will cause a high
  868.   disk-activity, this will take some time. Another reason for NOT marking
  869.   cross-postings is that if you 'catchup' a group you normally only mean
  870.   articles in this group.
  871.   So it depends on you whether you want to mark all cross-postings or not.
  872.   If this keyword is missing 'Arn' doesn't care about cross-postings if
  873.   you make a catchup.
  874.  
  875.  
  876.   3. Invoking "Arn!" (#5.3)
  877.  
  878.   "Arn" should be invoked from the CLI. It has a few commandline-switches
  879.   yet: Arn [-inpgXRP(n)] [-D directory]
  880.  
  881.   Switches can be set together after one '-' sign or each single:
  882.   "Arn -n -g" is the same as "Arn -ng". A wrong option lets Arn ignore
  883.   any further options.
  884.  
  885.   switches:
  886.   -i            print the version number and usage info.
  887.  
  888.   -n            look for new-newsgroups
  889.  
  890.   -p            starts "Arn" directly into "post article"-mode. After
  891.                 the article is posted (or not), "Arn" will quit.
  892.  
  893.   -X            start "Arn" in X-FILE-EXPIRE-mode. "Arn" will not open
  894.                 it's screen, but look for all X-files and delete old
  895.                 entries (that are those whose expirationdate is reached) in
  896.                 them. You should let run Arn regularly with this option by
  897.                 'dcron'.
  898.  
  899.   -R            Reset all entries in your GROUPLIST (all groups unmarked).
  900.  
  901.   -D directory  Arn uses this directory as newsgroup.
  902.                 All articles must be single numbers as in normal UUNEWS:
  903.                 newsgroup.
  904.                 No information about read/unread articles or this directory
  905.                 is saved after exiting.
  906.                 <directory> should specify a complete path and should have
  907.                 NO trailing "/".
  908.  
  909.   -g            Arn will prompt for a newsgroup-name after startup and goto
  910.                 to this group if it exists.
  911.  
  912.   -P(n)         The (n) is a placeholder for an integer between -127 and
  913.                 128. Example: arn -P-2X
  914.                 will start Arn with priority -2 in X-FILE-EXPIRE-mode
  915.  
  916.   Nevertheless, you can start Arn from Workbench, too. In this case, make
  917.   sure that you specified the full paths in .arnrc!
  918.  
  919.   You can close the CLI-Window from where you invoked "Arn", because
  920.   the Standard-Error is no longer used (all Errors will now appear on
  921.   Standard-Output -stdout).
  922.   To do this you must use the "run" from WB1.3, the NULL:-device must be
  923.   mounted and available and type the following:
  924.   "run <nil: >nil: Arn <nil: >nil:"
  925.   After "Arn" has launched you can close the CLI.
  926.  
  927.  
  928.   For users which do not use AmigaOS 2.0: Why is the Null:-Device needed?
  929.   Because "Arn" executes other programs and they need a valid
  930.   pr_ConsoleTask, which is missing if you close the CLI. Result: without
  931.   NULL: the machine would crash!
  932.  
  933.  
  934. o Running Arn (#6)
  935.   -----------
  936.   "Arn" will open its own One-Bitplane-Screen (that is MONOCHROME or
  937.   black/white). The cursor is now the block in the same colour as your
  938.   text.
  939.   Under AmigaOS 2.0 Arn will use your default screen-setup from your
  940.   preferences/workbench, but only monochrome.
  941.  
  942.   With OS-versions below 2.0 it will automatically get the correct
  943.   Screen/Window-Size, whether you have PAL or NTSC ("Arn" looks for the
  944.   gfxbase->NormalDisplayRows). At the moment the vertical-size is 80 Chars
  945.   or 640 Pixels (HIRES-Mode). But you can specify your own Screen-
  946.   Dimensions with SCREENDATA in .arnrc, see below. "Arn" takes the default
  947.   ROM-font (which is normally topaz.8). Maybe there are custom-fonts
  948.   possible in later versions of "Arn".
  949.  
  950.   If all system resources could be opened and both Config-files (.arnrc and
  951.   UUCONFIG) are correct, "Arn" will report "Initialization phase...ok!".
  952.   Otherwise "Arn" prints an error-message to Standard-Error or its own
  953.   screen (if opened). Possible error-messages are explained in the section
  954.   "Error-Messages".
  955.  
  956.   - Checking for new-newsgroups
  957.  
  958.   If your GROUPLIST-File doesn't exist, "Arn" automatically will ask you
  959.   for the newsgroups, you want to read. It will get all available
  960.   newsgroups from a file called "newsgroups" in your current OR the
  961.   "UULIB:" directory.
  962.   At Amiga-UUCP the file already exists as UULIB:newsgroups.
  963.   If you have an ACTIVEFILE then this activefile is taken instead of
  964.   "newsgroups", there's no need to create "newsgroups"!
  965.  
  966.   The newsgroups-file has the format:
  967.  
  968.   news.group
  969.   foo.bar
  970.   fred.test
  971.  
  972.   So just for each newsgroup-name one line. All entries following the
  973.   newsgroups-names are ignored (if separated by TAB or SPACE).
  974.  
  975.   Then "Arn" will read this "newsgroups"-file an check for missing groups
  976.   in GROUPLIST (you can force "Arn" to do this when starting it with "Arn
  977.   -n" or by pressing "^N" which means CTRL-N at the newsgroup-selector).
  978.   The sequence of presenting/scanning/reading newsgroups is determined
  979.   by the sequence of the GROUPLIST entries!!!
  980.   This procedure looks like this:
  981.  
  982.   foo.bar not in .newsrc!
  983.   Put foo.bar where? (t,B,l,n,q,?=help):
  984.  
  985.   Inputs are NOT case-sensitive!
  986.  
  987.   Type '?' (help) to get information what these characters mean:
  988.   t=Top,B=Bottom (default),l=List,n=Nil,q=QUIT
  989.  
  990.   You can type 'T' or 't' to insert it at the Top of all existing
  991.   newsgroups in your GROUPLIST.
  992.  
  993.   If you type 'B' or ANY other KEY than T,L,N or Q, the group is appended
  994.   to your list in GROUPLIST.
  995.  
  996.   Type 'L' to list all newsgroups that are already in GROUPLIST. "Arn" will
  997.   prompt now:
  998.   Input NUMBER, Q or RETURN:
  999.   You can now enter a number which specifies the exact position of the
  1000.   newsgroup in GROUPLIST. The new newsgroup will be inserted AT this
  1001.   number. If you type 'Q', you'll stop the list-function and return to the
  1002.   "Put it where" prompt.
  1003.  
  1004.   Type 'N' to skip this newsgroup, that means it will not be put in the
  1005.   GROUPLIST. The scanning for further new groups is continued.
  1006.  
  1007.   Type 'Q' to quit asking for new groups which are not found in the
  1008.   GROUPLIST.
  1009.  
  1010.  
  1011. o Command-Lines (#7)
  1012.   -------------
  1013.   "Arn" sometimes requests a more complex input than only one keystroke.
  1014.   At this time you will be put to the command-line where you can now type
  1015.   in upto 256 characters. Some examples of command-line invokations are the
  1016.   "g" or "s,w" commands at the article-selector (see below).
  1017.   Editing:
  1018.   You can move the cursor to the left with the [<-] (left-arrow) key, to
  1019.   the right with [->] respectively. If moving to the right the cursor will
  1020.   stop after reaching the last character. If you now type in normal letters
  1021.   they will be appended.
  1022.   Characters are INSERTED at the cursor position and the characters to the
  1023.   right are shifted. If the maximum input-length is reached, no further
  1024.   input will be accepted! You have to delete some other text first!
  1025.   To overwrite characters you have to delete them first and then to insert
  1026.   new ones.
  1027.  
  1028.   To delete characters just use the BACKSPACE-key as usual (the cursor
  1029.   deletes the next left character and moves to this position, all text from
  1030.   the right will move also one position to the left).
  1031.  
  1032.   The [Del]-key deletes the character under the cursor and moves all text
  1033.   from the right one position to left.
  1034.   The character-range for input is from SPACE to Tilde (ACSII (hex):0x20-
  1035.   0x7E).
  1036.  
  1037. o Newsgroup-Selection (#8)
  1038.   -------------------
  1039.  
  1040.   If "Arn" has started properly (no problems during startup-phase) it will
  1041.   show all groups with unread or 'new' articles. This looks like:
  1042. -------------------------------------------------------------------------------
  1043.  Arn by R.Bless -   55/75   Newsgroups - page   1 of 3     New/Unread/Total
  1044.   a N ka.general                                           2/     2(     5)
  1045.   b N control                                              1/     1(    28)
  1046.   c N junk                                                 3/     3(    40)
  1047.   d N alt.sys.amiga.uucp                                  11/    11(   142)
  1048.   e   alt.sys.amiga.uucp.patches                           0/     1(     8)
  1049.   f N sub.sys.amiga                                        7/     5(   284)
  1050.   g N comp.sys.amiga.programmer                           49/    49(   491)
  1051.   h N comp.sys.amiga.datacomm                              6/     6(   184)
  1052.   i N comp.sys.amiga.hardware                             22/    22(   341)
  1053.   j N comp.sys.amiga.misc                                  2/     2(    59)
  1054.   k   comp.sys.amiga.reviews                               0/     1(     1)
  1055.   l N comp.sys.amiga.emulations                           11/    77(    84)
  1056.   m N comp.sys.amiga.graphics                              2/     5(     5)
  1057.  >n N comp.sys.amiga.advocacy                       R      1/     0(     2)
  1058.   o N comp.sys.amiga.applications                         30/    77(   279)
  1059.   p N comp.sys.amiga.audio                                 7/    15(    82)
  1060.   q N comp.sys.amiga.introduction                          4/     9(    40)
  1061.   r N comp.sys.amiga.multimedia                            1/     1(    18)
  1062.   s   comp.unix.amiga                                      0/     1(     1)
  1063.   t N sub.config                                          23/    26(   314)
  1064.   u N sub.general                                          2/     5(    87)
  1065.   v N sub.studium                                          1/     3(    14)
  1066.   w N sub.misc                                            22/   190(   193)
  1067.   x N sub.mail                                             8/    11(    62)
  1068.   y N sub.comm                                             4/     4(    88)
  1069.   z N sub.umwelt                                           1/    35(    35)
  1070.  
  1071. -------------------------------------------------------------------------------
  1072.  
  1073.   The first line is the header-line:
  1074.  Arn by R.Bless -   55/75   Newsgroups - page   1 of 3     New/Unread/Total
  1075.  
  1076.   it shows how many groups are included in the current listing (here 55)
  1077.   and how many newsgroups are subscribed in your GROUPLIST subscribed
  1078.   (here a total of 75). Furthermore the number of the currently displayed
  1079.   page is shown as well as the total number of pages. New/Unread/Total is
  1080.   only the legend for the columns under it.
  1081.  
  1082.   The 'N' in the second column shows that there are 'new' articles since
  1083.   you last exited "Arn" with 'Q' which deletes all 'new' marks. You can
  1084.   also exit with 'X' to leave all marks as they are. If there arrive new
  1085.   articles, so the active file is changed, "Arn" will mark them as new.
  1086.  
  1087.   There are two ways reading news:
  1088.  
  1089.   For speedy news reading you can use the up/down cursor key to move to
  1090.   the desired group and press ENTER to get into the article selector.
  1091.   There you can select articles to read in the same way you did with
  1092.   the groups. See next chapter below for details.
  1093.  
  1094.   For sophisticated news reading you can select all the groups that are
  1095.   of your interest:
  1096.   To select a group just press the letter that stands before the groupname
  1097.   and the line of the selected article is now in inverse text.
  1098.   To select a range of groups press the letter of the first group then '-'
  1099.   and "Arn" prompts in the last line "Select range:" the next letter
  1100.   entered marks the end of your selection.
  1101.  
  1102.   You get to the next page with further newsgroups to select by pressing
  1103.   the SPACE-bar or cursor right. If you're on the last page an press SPACE
  1104.   you'll automatically enter the first selected group. You can press 'Z' to
  1105.   read the selected groups immediately independent on which page you are.
  1106.   If you finished reading one newsgroup you're automatically transferred
  1107.   into the next select group until you read all selected groups or exited
  1108.   with "Q" or "X".
  1109.  
  1110.   Here is an overview of all possible commands.
  1111.   The cursor keys are denoted as C_??, alternative/equivalent keys are
  1112.   separated with a comma
  1113.  
  1114.   Key -       Description
  1115.  
  1116.   C_UP
  1117.   C_DOWN    - Moves the '>' prompt up and down pointing to the current
  1118.               article.
  1119.  
  1120.   C_RIGHT,> - Displays the next page of newsgroups if there are any more.
  1121.   C_LEFT,<
  1122.  
  1123.   ^         - Go to the first page
  1124.  
  1125.   $         - Go to the last page.
  1126.  
  1127.   A         - Show all subscribed newsgroups (toggles).
  1128.  
  1129.   a..z      - One letter in lower case selects this article. If you
  1130.               press the '-' next, Arn waits for another lower case letter
  1131.               to specify a range.
  1132.  
  1133.   +         - Selects all groups that are marked as NEW.
  1134.  
  1135.   @         - Inverts any existing selection of the current page.
  1136.               You can select a whole page by pressing '@' when no
  1137.               selection exists.
  1138.  
  1139.   #         - Selects all groups on all pages (not only the current page).
  1140.  
  1141.   %         - Unselects all groups on all pages.
  1142.  
  1143.   ENTER     - Enter the group where your prompt points to.
  1144.               If the group doesn't contain unread or new articles, all
  1145.               existing articles are listed.
  1146.  
  1147.   G name - go to the named newsgroup. Resubscribe unsubscribed newsgroups
  1148.            this way, too. (case is not important!)
  1149.  
  1150.            To get to an EMPTY NEWSGROUP (i.e. with no or no unread
  1151.            articles), use the "g" command and "goto" the desired group.
  1152.            "Arn" will not complain if this group is actually empty, but
  1153.            will return to the newsgroup-dir.
  1154.  
  1155.   /pat  - search forward (/) or backwards (?) for the groupname containing
  1156.   ?pat    "pat". pat is a REGEXP. Not case sensitive!
  1157.  
  1158.   ^P -post a new article to the net. "Arn" will ask you for the desired
  1159.       newsgroup(s), the subject and distribution. Then it will invoke your
  1160.       favourite editor (see UUCONFIG) and display the correct header.
  1161.       Now you can enter your text. If you quit your editor, "Arn" will
  1162.       prompt some choices which are described in detail at the follow-up
  1163.       function (see->pager - how to do a follow-up).
  1164.  
  1165.   ^U - Unsubscribe this group!
  1166.        If your press this combination, "Arn" will not show you the news
  1167.        from this group any longer. This group is excluded from reading
  1168.        articles if you confirm "Arn's" question:
  1169.        "Really UNSUBSCRIBE XXXXXX? [y,N]:"
  1170.        You can resubscribe this group with the "g" (goto newsgroup) command
  1171.        in the newsgroup-selector, because it is NOT REMOVED from your
  1172.        GROUPLIST (to do this, try ^D)!
  1173.        If you go to an unsubscribed newsgroup and you don't want to
  1174.        resubscribe this group, it is nevertheless scanned and if it
  1175.        contains any messages they will be displayed. The status of this
  1176.        group is still "unsubscribed."
  1177.  
  1178.   C  - Catchup group that's in the cursor line. Note that crosspostings
  1179.        are not marked as read, unless you specify the CATCHUPXREFS keyword
  1180.        in .arnrc.
  1181.  
  1182.   K  - Turns local X-files on or off.
  1183.  
  1184.   ^G - Turns global X-files on or off.
  1185.  
  1186.   ^T - Shows or hides the ScreenTitle. This key-combination toggles.
  1187.        It is very useful if you've more than two screens open, because
  1188.        there's no other possibility to click them in front.
  1189.  
  1190.   ^D - Delete this newsgroup from GroupList.
  1191.        Unlike ^U this command really removes the actual Newsgroup from
  1192.        the GROUPLIST.
  1193.        (after confirming: "Really REMOVE XXX from GroupList? [y,N]:").
  1194.  
  1195.   ^S - Re-scan current newsgroup, respectively re-read the active-file.
  1196.        Then GOTO this newsgroup again.
  1197.  
  1198.   ^N - Check for new groups.
  1199.        This command will force "Arn" to look in your ACTIVEFILE (if
  1200.        enabled), "newsgroups" or "UULIB:newsgroups" for new groups which
  1201.        still are not in your GROUPLIST. The procedure is described in
  1202.        detail above (see RUNNING ARN - Checking for new-newsgroups).
  1203.  
  1204.   L  - List all newsgroups from grouplist and show their status:
  1205.        newsgroupname                        : U M D xxxxxx-yyyyyy
  1206.  
  1207.        The flags U M D stand for:
  1208.        U- This group is currently unsubscribed.
  1209.        M- This group is moderated.
  1210.        D- This group will be removed from GROUPLIST.
  1211.  
  1212.        Their negations are not shown.
  1213.        xxxxxx-yyyyyy is the first and last article number in this group.
  1214.  
  1215.   c     - Catch up. "Arn" will ask you for a confirmation. Mark all
  1216.           articles in this group as read! Goto next group.
  1217.  
  1218.   H     - activates a short help-list.
  1219.           The help file must be available. It is VERY IMPORTANT to remember
  1220.           this command...
  1221.           To stop displaying the help-file, just press 'q'.
  1222.  
  1223.   ^H    - Turns header-stop-mode on or off. See pager-commands.
  1224.  
  1225.   Q     - Quit "Arn".
  1226.           "Arn" will update it's GROUPLIST and wait for you to press any
  1227.           key. All articles that were marked as new are (the next time you
  1228.           use "Arn") considered as old.
  1229.  
  1230.   X     - Same as Q, but the new-marks are retained (not updated).
  1231.  
  1232.   ^Q     - Quits "Arn" without updating the GROUPLIST (Emergency-exit).
  1233.  
  1234.  
  1235.  
  1236.  
  1237. o Article Selection Commands (#9)
  1238.   --------------------------
  1239.  
  1240.   A typical article selection screen will look like this.
  1241.  -----------------------------------------------------------------------------
  1242. comp.sys.amiga.programmer - page   1 of   7 - 128 of 168
  1243.  a Dave Plonka      1.3/2.0 difference w/# of IDCMP messages     39  R      131
  1244.  b Peter Cherna     >                                            20 N       155
  1245.  c charon@ccwf.cc.u 2.04 ROMS on the 3000 -- Is there any wa     11  R      107
  1246.  d Joakim Rosqvist  68040 speed                                  16 N       151
  1247.  e Lee_Robert_Willi a new 1.3 Intuition interface builder        38  R       56
  1248.  f C A Wichura      Re: Absence of new uucp binaries???           -  R       68
  1249.  g Ralph Babel      Re: Allocmem() causes expunge(). When ca     45          43
  1250.  h Bruno Costa      Re: Amiga 2.04 fd files                      20          90
  1251.  i Chris Hanson     AmigaDOS StartNotify() and deletion. Bug     44          17
  1252.  j Peter Cherna     >                                            68          44
  1253.  k Chris Hanson     >                                             -          63
  1254.  l Ronn F. Black    AmigaVision Bug Discovered...                33          22
  1255.  m Markus Wild      Re: Are even HARD links broken under 2.0     45           5
  1256. >n Mike Meyer       >                                            22           7
  1257.  o Michael B. Smith >                                             -          64
  1258.  p Chris Hooper     >                                             -          86
  1259.  q Mike Meyer       >                                            55         112
  1260.  r Chris Hooper     >                                            34 N       166
  1261.  s Jeff Dickson     Re: Assembler addressing mode                19  R       95
  1262.  t Wolf Faust       Re: Bug in 2.04 parallel device driver?      31  R       84
  1263.  u Mike Schwartz    C Comment question                           13  R      100
  1264.  v Matija Milostnik >                                            22  R      104
  1265.  w Jeff Dickson     >                                            16  R      117
  1266.  x Jeff Dickson     >                                            17  R      122
  1267.  y Brett Bourbin    >                                             -  R      126
  1268.  z Craig Fisher     >                                            26  R      134
  1269.  -----------------------------------------------------------------------------
  1270.  
  1271.  The first line shows the groupname that is displayed, the number of the
  1272.  page that is actually shown the number of pages available and the number
  1273.  of displayed articles on that pages as well as the number of total articles
  1274.  available in this group. In the example above there are 40 articles not
  1275.  displayed (read earlier) which you can display with 'A' (show all).
  1276.  
  1277.  The name of the author is displayed (Arnmaster tries to find the realname
  1278.  and cuts it to 16 chars maximum, if this fails (nobody) is displayed
  1279.  instead) and after it the subject.
  1280.  FollowUps to an article are marked with > instead with the subject.
  1281.  If there is a parent article, the subject is always printed. If the
  1282.  sequence of articles is not the chronological, you'll see something
  1283.  like this:
  1284.    Re: foobar
  1285.    >
  1286.    >
  1287.    foobar
  1288.    >
  1289.    >
  1290.  where foobar is the parent article.
  1291.  
  1292.  Then the number of lines contained in that article follows. If there is a
  1293.  '-' instead it means that Arnmaster could not find the "Lines:" line in
  1294.  the article.
  1295.  The flag-field is shown next, 'N' means new, 'R' read, 'D' deleted.
  1296.  The last field shows the article number of that article in this group.
  1297.  
  1298.  As in the group-selection-level you can read the article in two ways.
  1299.  
  1300.  Move the cursor to the desired article and press ENTER, the pager now shows
  1301.  the article.
  1302.  
  1303.  Or select individually with 'a'..'z','+','@','#' articles. Interesting is
  1304.  the '*' feature: It selects the whole unread thread of articles that have
  1305.  the same subject as the last one you have selected.
  1306.  
  1307.  SPACE takes you through all pages and starts the pager for reading the
  1308.  whole bunch of selected news when at the last page. Alternately, you can
  1309.  use 'Z' or 'TAB' to immediately read your selected articles. 'TAB' does
  1310.  automatically a catchup (i.e. mark ALL articles in this group as read) if
  1311.  you've read all the articles and takes you to the next selected group or
  1312.  if there is none to the group-selection-level.
  1313.  
  1314.  ENTER   - displays article which is on your cursorline.
  1315.  
  1316.  SPACE   - show next page of articles.
  1317.            If on last page, read selected articles. If there are none selected
  1318.            you get to the next select group or back to the group-selection.
  1319.  
  1320.  Selection:
  1321.  
  1322.  'a'..'z'- selects a single article for later reading.
  1323.            To select a range type <start letter>'-'<end letter> (to select
  1324.            articles c-e type 'c-e').
  1325.  *       - select all unread articles with same subject as the previous
  1326.            selected.
  1327.  +       - select all new articles.
  1328.  @       - invert the selection (selects whole page if no article selected).
  1329.  #       - select all articles.
  1330.  A       - show all articles (not only unread and new). This function
  1331.            toggles.
  1332.  Z       - read all selected articles immediately
  1333.  TAB     - read all selected articles at once and then catchup that group.
  1334.  
  1335.  Moving:
  1336.  C-UP    - cursor up.
  1337.  C-DOWN  - cursor down.
  1338.  C-RIGHT - same as space.
  1339.  C-LEFT  - one page back.
  1340.  ^       - go to first page.
  1341.  $       - go to last page.
  1342.  
  1343.  Actions:
  1344.  J       - junk. Mark the article in the cursor line as read. (Doesn't mark
  1345.            crosspostings, yet)
  1346.  C       - catch up. Mark all articles in this group as read! Goto next group.
  1347.  ^U      - unsubscribe this group (this group will not be displayed)!
  1348.  ^T      - show/hide ScreenTitle.
  1349.  ^P      - Post an article to this group.
  1350.  ^K      - Add subject or author to your local/global X-file or edit it.
  1351.  K       - Turn local X-file on/off. Articles are Xed next time you enter
  1352.            this group again.
  1353.  ^G      - Turn global X-file on/off.
  1354.  V       - Version info.
  1355.  
  1356.  Exiting the group:
  1357.  N,P     - go to next or previous selected newsgroup.
  1358.  Q       - Quit reading this group. Go to next selected group.
  1359.  X       - Go back to newsgroup-selector.
  1360.  ^Q      - Leave Arn immediately (GROUPLIST is not saved!).
  1361.  
  1362.  If you press SPACE on last page or 'Z' or TAB and there are selected
  1363.  articles, you'll enter the pager, the lowest level in "Arn".
  1364.  
  1365.  
  1366. o The pager (#10)
  1367.   ---------
  1368.  
  1369.   * Display features (#10.1)
  1370.  
  1371.   "Arn" will display an article beginning with the line:
  1372.   Article XXX (of XXX) in XXXXXXX.
  1373.           ^^^     ^^^     ^^^ actual newsgroup
  1374.           |||     Last article-number in this group.
  1375.   Current article-number
  1376.  
  1377.   Then follows the header (that are the first lines until a newline is
  1378.   detected). The following lines are automatically hidden by "Arn" and
  1379.   can be displayed by pressing 'v' (verbose header):
  1380.   - Path:
  1381.   + References:
  1382.   + X
  1383.   + Nf-
  1384.   - Reply-To:
  1385.  
  1386.   All header lines beginning with these characters will not be shown.
  1387.   A prefix - means that line-continuation is not checked, a + means that
  1388.   it is considered.
  1389.   The "Subject:"-line is underlined.
  1390.   The text follows after the header and each line is carefully registered
  1391.   in its length so that "Arn" stops after your Screen is filled up (this is
  1392.   not the whole truth: "Arn" will always display the next n-1 lines, if
  1393.   your screen has a maximum of n lines, to let you always see/remember the
  1394.   last line from the previous page...). Even TABS are counted, so no text
  1395.   will scroll off the screen until you pressed a key!
  1396.   If the next line is very long, "Arn" can stop before the bottom line has
  1397.   been reached.
  1398.   If "Arn" detects a ^L (ASCII-12=FormFeed) it just will behave as it has
  1399.   reached the n-1 lines: it will stop and prompt:
  1400.   --- MORE (XX %) <XXX> (XX) ---
  1401.             ^^     ^^^   ^^
  1402.             |        |   number of unread articles in this group
  1403.             |        --- Article-number
  1404.             --- percent of displayed text
  1405.  
  1406.   (If "Arn" detects a ^L IN a line then the output of this line is slowed
  1407.   down! If this ^L is not in the first column, any commands are ignored,
  1408.   until to the end of this line.)
  1409.  
  1410.   After the number of unread articles there can be some letters in brackets
  1411.   {}. This shows the article status (R for read,D for marked as deleted).
  1412.  
  1413.   If you read all the text, that means you're at the end of this article
  1414.   or the article contains only one page, "Arn" prompts:
  1415.   "End of article <XXX> in XXXXXX (XXX). What now?[npq]:"
  1416.                    ^^^     ^       ^^^number of unread articles in this
  1417.          Article-number    |          group.
  1418.                            Newsgroup-name
  1419.  
  1420.   Yet the number of unread articles INCLUDES the actual displayed article,
  1421.   even you just read it.
  1422.   It will be marked as read (and all crosspostings, too, if your UUCP-
  1423.   software generates an Xref:-line) if you now press the SPACE-BAR. So if
  1424.   the last article in a newsgroup is reached, you will see that there's
  1425.   still one article unread (that's the one you're reading).
  1426.  
  1427.   Now you can enter some pager-commands ('h' or 'H' for help exists here,
  1428.   too!):
  1429.  
  1430.   * Basic pager commands (#10.2)
  1431.  
  1432.   ^R - restarts the current article (disables rot(13) mode).
  1433.   v  - restarts the current article with a verbose header (see above).
  1434.  
  1435.   ^B - Display previous page. Displays the previous page(s) scrolled off.
  1436.        (turns rot-mode off)
  1437.  
  1438.   ^L - Redisplay the last page. Helpful after pressing 'h','H' for help.
  1439.  
  1440.   L  - Turns clear-screen-mode on or off (default is OFF).
  1441.        If this mode is enabled the screen is cleared before showing the
  1442.        next page. Useful if you use more than one bitplane and you think
  1443.        scrolling is to slow. This key toggles.
  1444.  
  1445.   ^H - Turns header-stop-mode on or off (default is OFF).
  1446.        If this mode is enabled, "Arn" stops after displaying the header
  1447.        and prompts its "--more--". This key toggles.
  1448.        (If you turn this mode off at the header-prompt, you'll be at the
  1449.         end of this article. This is no bug, but it's not so easy to change
  1450.         it)
  1451.  
  1452.   x  - display next page in rot(13) mode.
  1453.  
  1454.   X  - redisplay this page in rot(13) mode.
  1455.  
  1456.   ^X - restart current article in rot(13) mode.
  1457.  
  1458.   T num - Enter a new rot-number (default is 13). If the text is encrypted
  1459.           with rot 18, you must use rot 8 to decrypt it.
  1460.  
  1461.   SPACE - SPACE BAR displays next page, if at the end of an article ONLY
  1462.           this key and ENTER will mark your article as READ (plus all
  1463.           articles in the appropriate groups if it is a crossposting and
  1464.           your news- system supports the Xref: line) and searches for the
  1465.           next selected article. If there is none you'll get to the next
  1466.           selected group, if any.
  1467.  
  1468.   RETURN/
  1469.   ENTER - Displays only the next line. If pressed at the end of an article
  1470.           this article will be marked as read.
  1471.  
  1472.   g pat - searches in this article for given pattern (valid REGEXP)
  1473.           starting at the top. This search is NOT CASE DEPENDENT!
  1474.           If the pattern is found, the line containing this pattern is
  1475.           displayed in the first line of the screen, otherwise "Arn"
  1476.           displays "NOT FOUND!".
  1477.  
  1478.   G     - continue search for pattern ('see g').
  1479.  
  1480.   TAB   - will also display the next page of text, but does nothing if at
  1481.           the end of the article.
  1482.  
  1483.   "Arn" will continue displaying this article if you type SPACE or TAB. If
  1484.   stopped at an ^L (FF), it will display "^L" instead of the real code.
  1485.   The line limit is 1024 Bytes (then the line is not longer considered as
  1486.   one line!)
  1487.  
  1488.   * Moving to articles in pager (#10.3)
  1489.  
  1490.   n,N - read next selected article (leaves the current article unread!).
  1491.         NOTE: Only 'j' marks this article as read or the SPACE BAR if
  1492.         pressed at the "End of article <XXX> in XXXXXX (XXX). What
  1493.         now?[npq]:"!!!
  1494.  
  1495.   p,P - read previous selected article.
  1496.  
  1497.   number - goto article with this number. A number is the set of '0'..'9'.
  1498.            "Arn" will enter the Command-Mode if you enter a number. Just
  1499.            press RETURN/ENTER after you typed in the desired number. "Arn"
  1500.            now jumps directly to this article (if available, otherwise it
  1501.            does nothing).
  1502.  
  1503.   (NOT IMPLEMENTED YET)
  1504.   /pat~mod - searches for pat in articles (default: only the "Subject:"-
  1505.              line is scanned). pat must be a valid REGEXP.
  1506.              Modifiers: c- case dependent search,
  1507.                         a- search for pat in the whole article/text,
  1508.                         h- search in header
  1509.                         r- search in read articles too
  1510.  
  1511.              If no modifiers are given, the default is:
  1512.              - search in "Subject:"-line only
  1513.              - case independent search
  1514.              - search in unread articles only
  1515.  
  1516.              / only (no pattern or modifiers) means to SEARCH AGAIN with
  1517.                the last pattern and settings.
  1518.  
  1519.              To abort the search, just press ANY key (it's your task to
  1520.              keep your fingers away...).
  1521.              (Note: Yet it is impossible to search for / itself)
  1522.  
  1523.   (NOT IMPLEMENTED YET)
  1524.   ?pat~mod - to search in the other direction (? alone searches for the
  1525.              same pattern "backwards"). See explanations for "/pat~mod"
  1526.              above.
  1527.  
  1528.   * Posting, replying, forwarding, cancel (#10.4)
  1529.  
  1530.   f,F - Invokes your editor and produces a FOLLOW-UP.
  1531.         (see also SCREENSW in .arnrc)
  1532.         This function should only be used if your answer is informative
  1533.         enough for the whole readership, otherwise you should prefer the
  1534.         REPLY-function. You are not able to enter a follow-up if you're
  1535.         reading a moderated group (the ACTIVEFILE must be used, see
  1536.         Installing Arn - 2. ".arnrc" - ACTIVEFILE).
  1537.         If you're the moderator, just change the "m" in the active-file
  1538.         to "y" and you're able to post to this group.
  1539.  
  1540.         'F' will include the original-article text, but with the QUOTECHAR
  1541.         inserted before each line! Quote only the important passages for
  1542.         easier remembering the subject, not the whole article!
  1543.         Try to summarize if possible.
  1544.  
  1545.         "Arn" generates a temporary file in your T: directory.
  1546.         The header contains all the required lines (RFC 1036) as
  1547.         RELAY and POSTING-VERSION (see "Installing-Arn -
  1548.         2.Configuration-file").
  1549.         All entries taken from the original-article get here with respect
  1550.         to the "line-continuation" (a header line can be continued if it
  1551.  
  1552.         The "Newsgroups:" line contains the same newsgroups as the
  1553.         "FollowUp-To:"-line of the original-article (if exists), otherwise
  1554.         the "Newsgroups:"-line from the original article is copied.
  1555.         If the FollowUp-To:-line contains more than one newsgroupname
  1556.         (one comma to separate), the following WARNING is displayed.
  1557.         "WARNING: Ambiguous FollowUp-To:-Line! Please (e)dit!"
  1558.         You should enter your editor once more and redirect the discussion
  1559.         into only one newsgroup, but if you like, you can also suggest two
  1560.         or more newsgroups (it's just a WARNING-message...).
  1561.  
  1562.         The "Subject:"/"Title:"-line is generated by inserting a "Re: "
  1563.         before the original "Subject:"-line, but only if this line didn't
  1564.         begin with "Re:" or "Re^"!
  1565.         The "Reply-To:"-address is either directly taken from your .arnrc
  1566.         (REPLYTO) or UserName@NodeNameDomainName.
  1567.         The "FollowUp-To:"-line is identical with the "Newsgroups:" line.
  1568.         It should only contain one newsgroup-name, to direct the follow-ups
  1569.         into one group.
  1570.         The "References:" is either created or copied from the original
  1571.         article. The "Message-ID:" of the original article is appended
  1572.         ("Arn" does an automatic wrap around of long references lines).
  1573.         ** IMPORTANT: **
  1574.         If nevertheless your EDITOR wraps lines around, make sure that the
  1575.         new lines BEGIN with SPACE or TAB-characters (LINE-CONTINUATION!)!
  1576.  
  1577.         The "Distribution:" is copied unchanged.
  1578.         The "Organization:" is appended if available from UUCONFIG.
  1579.         The "Lines:"-line is inserted, if you really send the article.
  1580.  
  1581.         AFTER AT LEAST ONE BLANK LINE you can write your text or the
  1582.         included/quoted text follows after a line like this:
  1583.         "In article <1234@foosite.foo.bar> Freddy Foobar writes:"
  1584.         (If the realname is missing, the address is taken).
  1585.         "Arn" doesn't support multiple parentheses like:
  1586.         "(Freddy Foobar (the world's best))"
  1587.         The RFC 1036 says that this should be avoided!!
  1588.  
  1589.         REMEMBER TO LEAVE AT LEAST ONE BLANK LINE BETWEEN THE HEADER AND
  1590.         THE MESSAGE-BODY/TEXT!
  1591.  
  1592.         Your SIGNATURE (from .arnrc) will be added behind the header.
  1593.  
  1594.         After you've finished your editor, "Arn" will prompt:
  1595.         "p)ost, e)dit, f)ilter, a)bort:"
  1596.  
  1597.         If you type "p", "Arn" will check the header for redundant lines
  1598.         and removes them, the FollowUpTo-line is removed if it's
  1599.         identical with the Newsgroups-line.
  1600.         Then the article is sent to your SENDNEWS-program that is typically
  1601.         to your spool-directory respectively newsfeed. After that, "Arn"
  1602.         executes the SELFSEND-program if the entry in the .arnrc exists/is
  1603.         valid.
  1604.  
  1605.         NOTE:
  1606.                              *********************
  1607.         The contents of your posting are not checked/changed after editing,
  1608.         so  YOU ARE RESPONSIBLE FOR ANY NONSENSE IN THE MESSAGE-HEADER!
  1609.         (and the trouble you'll get)
  1610.                              *********************
  1611.  
  1612.  
  1613.         With "e" you'll enter your editor once more.
  1614.  
  1615.         With "f" you can invoke a filter program that changes your article.
  1616.         See FILTER in .arnrc
  1617.  
  1618.         With "a" you don't send this article to the net! The article
  1619.         remains still in your T: directory as T:CancelledArt.<UserName>!
  1620.  
  1621.         If you didn't change the article at all, "Arn" will a)bort
  1622.         automatically.
  1623.  
  1624.   How to post an article:
  1625.  
  1626.   E   - enter a new message (post new article to the net).
  1627.         "Arn" will render you to post a new article to this newsgroup.
  1628.         (if not moderated! For details see Follow-up).
  1629.  
  1630.   How to cancel a posting:
  1631.  
  1632.   C     - Cancel this article, if it is yours. A control-posting is created
  1633.           if the From:-line contains "UserName@NodeNameDomainName"! The
  1634.           editor is invoked, same procedure as with follow-up. The cancel
  1635.           function will send a control-article which is distributed just
  1636.           as normal news-articles, but because it is a control-article, it
  1637.           will cause the news-sites to cancel (delete) the article where
  1638.           you pressed this key. This function is always useful, if you
  1639.           posted an article to the net and it already leaved your system,
  1640.           but you nevertheless want to withdraw it (maybe you posted
  1641.           nonsense, flames...).
  1642.  
  1643.   How to response by mail:
  1644.  
  1645.   r,R - Reply. Invokes editor and produces a reply ('R' for quoting text),
  1646.         that is E-mail (private-Mail).
  1647.         Attention: No "From:"-line is generated. This is normally the job
  1648.         of your sendmail-program (AmigaUUCP: sendmail -f user)...if this is
  1649.         nevertheless not possible, use the MAILOPTS in .arnrc or try it
  1650.         with a script file (see above SENDMAIL) and write me which program
  1651.         has this problems. The principle is the same as with FollowUps, but
  1652.         this article then is sent as E-MAIL through SENDMAIL.
  1653.  
  1654.         The "To:"-address is created from the following lines:
  1655.         "Reply-To:"    if available, otherwise
  1656.         "Return-Path:" if available, otherwise
  1657.         "From:"
  1658.  
  1659.         Two empty "Cc:" and "Bcc:" lines are created.
  1660.         The "Subject:"-line follows the same rules as in followup-
  1661.         articles.
  1662.         A line "In-Reply-To:" is generated containing the articles
  1663.         Message-ID and the newsgroup it is from.
  1664.  
  1665.         If quoting ('R'), "Arn" creates a first line of text like this:
  1666.         "In sub.culture.foobars, article <1234@foosite.UUCP>, you wrote:"
  1667.  
  1668.         If not quoting this line looks like this:
  1669.         "This is a reply to your article <1234@foosite.UUCP>,
  1670.          in sub.culture.foobars"
  1671.  
  1672.         Your signature is included after the header. If you don't want
  1673.         a signature, delete it within your editor.
  1674.  
  1675.         After finished writing the article, "Arn" will prompt:
  1676.         "s)end, e)dit, a)bort:"
  1677.  
  1678.         The message "Sending mail..." is NO PROOF that your mail really
  1679.         will be spooled/sent off! You must be sure that your entry in
  1680.         .arnrc is correct and that this mail is really sent (try it
  1681.         once!).
  1682.  
  1683.         If you didn't change the article at all, "Arn" will a)bort
  1684.         automatically. If you aborted or an error occured the mail remains
  1685.         still in your T: directory as T:CancelledArt.<UserName>!
  1686.  
  1687.  
  1688.   ^W -  Forward this article to other persons by E-Mail.
  1689.         This command is similiar to 'R', but you can specify the
  1690.         mail-addresses.
  1691.  
  1692.   * Other commands (#10.5)
  1693.  
  1694.   Archiving articles:
  1695.  
  1696.   s,w name - appends article(s) to a file.
  1697.              "Arn" appends it to the file "name" in the directory SAVENEWS:
  1698.              (see .arnrc), if given, else to SAVENEWS:groupname if no name
  1699.              is specified!
  1700.              You can save it/them to other directories/devices by
  1701.              specifying the FULL-PATH NAME containing a colon ":".
  1702.              This even works for prt:, so you can easily print articles
  1703.              with "s prt:"! These commands can be preceeded by a range!
  1704.              Examples:
  1705.              (assuming SAVENEWS is UUCP:usr/rob/News and the current
  1706.               newsgroup is comp.sys.amiga)
  1707.  
  1708.              "s" - appends article with header to
  1709.                    UUCP:usr/rob/News/comp.sys.amiga
  1710.              "w help" - appends article without header to
  1711.                         UUCP:usr/rob/News/help
  1712.              "1000,1010-1040 s" - appends full articles 1000,1010-1040 to
  1713.                                   UUCP:usr/rob/News/comp.sys.amiga
  1714.              "s UUCP:tmp/help" - appends full article to UUCP:tmp/help
  1715.  
  1716.              If the "name" begins with a '|', the rest of "name" and all
  1717.              following text will be considered as shell-commands.
  1718.              Save the article to Standard-Input of the following command
  1719.              (PIPING):
  1720.              "s |sort to RAM:test" will pass the article to standard-input
  1721.              of "sort", which then will put the result into RAM:test.
  1722.              "s | sort to RAM:test" is allowed also.
  1723.              NOTE: "s |" and "w |" commands will sent all further output to
  1724.              NULL:! So redirect your output if necessary or use the S/W/|!
  1725.              But "S" and "W" will open a SHELLWINDOW (see .arnrc) and this
  1726.              will act as input/output stream. To get rid of this window and
  1727.              to reenter "Arn", just type "endcli" to the CLI-command
  1728.              prompt. "S" is equivalent with "S |" and "|", "W" with "W |".
  1729.  
  1730.              This is NOT a REAL PIPING mechanism, because I didn't use the
  1731.              PIPE: device and I had to "run" the commands following "s |".
  1732.              This function creates a temporary-file in T: and then
  1733.              redirects the input-stream of the following program to this
  1734.              temp-file. The temp-file is then deleted.
  1735.              "s |command options further_commands" is executed as
  1736.              command <PIPE_tmpfile options further_commands. With ARP and
  1737.              the PIP-device, you're able to do multiple pipes:
  1738.               "S search STDIN fred | sort | type to RAM:test NUMBER"
  1739.  
  1740.   "|"   - is shorthand for "S |".
  1741.  
  1742.   Marking articles (read or deleted):
  1743.  
  1744.   d,^D  - mark article as deleted ('d' skips to next unread,
  1745.           '^D' stays at the current article). Don't use this function if
  1746.           you have an "expire" and an active-file!!!!
  1747.  
  1748.           WARNING:
  1749.           ** Your databases are maybe not updated correctly if you delete
  1750.              articles manually! This causes to mix up old subjects with new
  1751.              articles. You should delete all databases and then rescan all
  1752.              groups (see arnmaster.doc).
  1753.  
  1754.           Nevertheless, this function IS USEFUL:
  1755.           For AMIGA-Owners which don't have enough free space on their
  1756.           (hard-)disks to use an expire. They can read the articles and
  1757.           have directly free storage again.
  1758.           Or if there are large articles or binaries which you want to
  1759.           delete earlier, you can do it directly in your newsreader.
  1760.           Since the AMIGA is no Multiuser-System there is no need to
  1761.           protect this function against abuse. Most of the time the
  1762.           "system-operator" is the only one who reads news and has anyway
  1763.           the full control over the system...if you unintentionally marked
  1764.           an article as deleted, you can direct "Arn" not really to delete
  1765.           the article(s).
  1766.           Aborting the deletion (Answer 'N' at the "Really delete...")
  1767.           removes all "deletion marks" from the articles, but leaves them
  1768.           marked as read. 'r', reenter, leaves all articles marked as they
  1769.           were (deleted and read). You now can reenter the group once again
  1770.           and do something...
  1771.           You can remove all the del-marks by typing "1-$:d D".
  1772.  
  1773.           However, if you prefer an expire and an active-file just don't
  1774.           use this funtion!
  1775.  
  1776.   D     - remove the delete mark from article.
  1777.  
  1778.   u     - don't mark this article as read.
  1779.           Note: this will not unmark all crosspostings, too.
  1780.  
  1781.   j     - junk this article (mark it as read) and do 'n'.
  1782.           (If your UUCP-software supports Xref-Lines (CNews and
  1783.            //\\migaUUCP Plus do), all crosspostings are marked
  1784.            as read, too).
  1785.  
  1786.   J     - mark this article as read, but stay at this article.
  1787.  
  1788.  
  1789.   c     - Catch up. "Arn" will ask you for a confirmation. Mark all
  1790.           articles as read! Goto next group.
  1791.  
  1792.   Miscellaneous:
  1793.  
  1794.   o     - other program. This key invokes the external program EXTERNALPRG
  1795.           if specified in .arnrc
  1796.  
  1797.   ^T    - Show ScreenTitle. This key toggles (show/hide).
  1798.           The window is resized and the ^L command is issued.
  1799.  
  1800.   ^G    - Show current newsgroup status.
  1801.  
  1802.   ^S    - Quit reading this newsgroup and rescan articles, respectively
  1803.           re-read the active-file. Then GOTO this newsgroup again.
  1804.  
  1805.   h,H   - HELP. Display the help-text.
  1806.  
  1807.   * Range commands (#10.6)
  1808.  
  1809.   Range commands are executed only for some listed articles. You can
  1810.   additionally specify filter flags to restrict the field of activity.
  1811.   You first specify the range and then the command that is applied to
  1812.   it. Note that you can select articles and then use range command
  1813.   to save them for example ("1-$:s s T:test")
  1814.  
  1815.   range cmd- A range consists of one or more subranges:
  1816.  
  1817.              range:== subrange{","subrange}
  1818.              subrange:== number{":"flags} | number"-"number{":"flags}
  1819.              flags:== [minflag]
  1820.              minflag:== "u" | "U" | "r" | "R" | "d" | "D"
  1821.              number:== [digit] | "^" | "." | "$"
  1822.              digit:==  "0" | "1" | "2" | "3" | "4" |
  1823.                        "5" | "6" | "7" | "8" | "9"
  1824.  
  1825.              [x] denotes one or more occurrences of x.
  1826.              {x} denotes zero or more occurrences of x.
  1827.              |  means "or"
  1828.  
  1829.              special numbers: ^ first article, $ last article,
  1830.                               . current article.
  1831.              valid flags: U,u,R - unread; r - read; D - not deleted;
  1832.                           d - deleted; s - selected; S - not selected
  1833.  
  1834.              cmd is one of =,r/j,u/U,x/d,D,w,W,s,S,|
  1835.  
  1836.              / means alternatively and | is here the "Pipe" sign (not
  1837.              longer "or") and part of the commmand.
  1838.  
  1839.              j,r - mark it read; u,U - mark it unread;
  1840.              x,d - mark it deleted; D - mark it undeleted;
  1841.              w,s - w,W,s,S,| -> see above (save,write)
  1842.  
  1843.   Leave the pager:
  1844.  
  1845.   q     - Quit reading this article (let it marked read or unread).
  1846.           Go to next selected article if any.
  1847.  
  1848.   Q     - Quit reading this article and goto the article selection or
  1849.           next selected group.
  1850.  
  1851. o X-files (#11)
  1852.   -------
  1853.  
  1854.   To automagically suppress messages you're not interested in, you now can
  1855.   use the X-file (aka "kill-file", but that's to aggressive IMHO).
  1856.  
  1857.   Unread messages that are matched by the entries in your X-file are simply
  1858.   skipped and marked as read ("junked") if you're reading articles.
  1859.  
  1860.   You normally have two levels of X-files: global X-files and local ones.
  1861.   Global X-files are examined in EACH newsgroup, unless you turn this
  1862.   feature off with the 'k'-command in the newsgroup-selection-level.
  1863.   Local X-files are only active in your current newsgroup you're reading
  1864.   (you can also turn them off in newsgroup-sel.-level with 'K') and
  1865.   therefore can be different for every newsgroup.
  1866.  
  1867.   The easiest way to create/use X-files is to use the '^K'-command in
  1868.   the pager-/article-selection-level.
  1869.  
  1870.   You'll see this line then:
  1871.  
  1872.   Edit G)lobal, Edit L)ocal, S)ubject, A)uthor, T)hread, Q)uit:
  1873.  
  1874.   To get rid of all articles that have the same subject press 'S', e.g.
  1875.   or 'A' to skip all messages written by this author. 'T' puts the first
  1876.   Message-ID of the References-line into the X-file and therefore skips
  1877.   all articles refering to this Msg-ID (to abort type 'Q').
  1878.   If you've selected one of the three above, a second prompt asks for the
  1879.   X-file-level, that is global or local. Arn will add/create the entry in
  1880.   the X-file automatically for you.
  1881.  
  1882.   You naturally can add manually entries which is normally easy. An X-file
  1883.   entry looks like this:
  1884.  
  1885.   Header-field:/regular-expression~command expirationdate
  1886.  
  1887.   If the header field is missing "Subject:" is default.
  1888.   The regular expression is an V8-regexp, which is explained in detail in
  1889.   regexp.doc.
  1890.   command is 'j'(junk) or 'd'(mark for deletion) or 's'(autoselect). Again
  1891.   junk is default if this field is omitted.
  1892.   For Autoselection, i.e. articles that match are selected if you enter
  1893.   this group, you must specify the 's' command.
  1894.  
  1895.   The lifetime of each entry can be limited to the expirationdate. This
  1896.   is optional, if there is none expirationdate specified, the lifetime
  1897.   of this entry is unlimited (unless you delete it by hand!).
  1898.   Note that the entry is only IGNORED if the expirationdate is reached.
  1899.   To physically delete the redundant lines, you must start "Arn" with
  1900.   command-line option "-X". This inconvenience is because of better
  1901.   performance during reading articles. I recommend to run regularly
  1902.   "Arn -X" via "dcron".
  1903.  
  1904.   "Arn" sets the lifetime automatically to XLIFETIME days, if you're adding
  1905.   entries with "S","A","T" or "K".
  1906.  
  1907.   The expirationdate has the format:
  1908.  
  1909.   ddmmyyyy
  1910.  
  1911.   dd-day, mm-month, yyyy-year
  1912.  
  1913.   The / and ~ are separators and can be obtained itself by doubling:
  1914.   // is the slash itself or ~~ accordingly tilde.
  1915.   Please note that you have to override special regexp-meta-signs by
  1916.   \ (backslash) (but Arn makes it at S,A,T automatically).
  1917.  
  1918.   BTW: Concerning 'S': Arn limits the subject to 30 characters.
  1919.  
  1920.   X-files consider only HEADERS for matching patterns at the moment.
  1921.   You can specify the header field like From:, Keywords:, Summary:, etc.
  1922.   as mentioned above.
  1923.  
  1924.   Local X-files are named ".X<UserName>" and located in the newsgroup
  1925.   sub-dir. The global-X-file is named ".glX<UserName>" and is located in
  1926.   the same directory as your GROUPLIST-file is.
  1927.  
  1928.   Note: If you're searching for a subject ('/') and this subject is in
  1929.         your X-file, "Arn" will execute the X-command (junk, delete)
  1930.         and skip to the next article not in your X-file. This behaviour
  1931.         may be changed in future.
  1932.  
  1933.  
  1934. o REGEXP (#12)
  1935.   ------
  1936.  
  1937.   Regular expressions are somewhat complex and not always easy to
  1938.   understand, but you normally won't need all the features, so don't worry!
  1939.   (Syntax in a BNF-like form)
  1940.  
  1941.   Valid regular expressions:
  1942.  
  1943.   terminal symbols are enclosed in ' ', they mean the textual symbol itself.
  1944.   nonterminal symbols are enclosed in < >.
  1945.   {x} denotes zero or more occurrences of x.
  1946.   [x] denotes one or more occurrences of x.
  1947.   |  means "or"
  1948.  
  1949.   <regexp>:== <branch>{'|'<branch>}
  1950.   <branch>:== {<piece>}
  1951.   <piece>:== <atom>
  1952.   <piece>:== <atom>'*'   (matches sequence of 0 or more matches of the atom)
  1953.   <piece>:== <atom>'+'   (matches sequence of 1 or more matches of the atom)
  1954.   <piece>:== <atom>'?'   (matches a match of the atom or the null-string)
  1955.   <atom> :== '('<regexp>')' | <range> | '.' | '^' | '$' | '\'<char> | <char>
  1956.  
  1957.   '.' matches ANY character
  1958.   '^' matches the NULL-string at the beginning
  1959.   '$' matches the NULL-string at the end
  1960.   '\' matches the character that immediately follows.
  1961.  
  1962.   <range>:== '['<sequence>']'  matches any single character from the <sequence>
  1963.   <sequence>:== [<char>] | <char>'-'<char> | '^'[char]
  1964.   '-' means the full list of ASCII characters between the two characters.
  1965.   '^' means "not", so it matches all characters not from the rest of the
  1966.   sequence.
  1967.   To include ']' or '-' in the sequence make it the fist character in the
  1968.   sequence.
  1969.  
  1970.   <char> :== any valid character (esp. 'A'-'Z','a'-'z','0'-'9')
  1971.  
  1972.   To override the meta-characters *,-,. etc. use the backslash before
  1973.   (\* means the asterisk itself). Somehow, this seems not always to work as
  1974.   one expects. Didn't have the time to figure it out, yet.
  1975.  
  1976.   Puuhh! Sorry for that. Now some concrete examples:
  1977.  
  1978.   regexp                           match                       no match
  1979.   ----------------------------------------------------------------------
  1980.   abc                              aabbaaaabc                  abababacb
  1981.   Multiple words are allowed       Multiple words are allowed  Multiple
  1982.   abc|abd                          abababd                     xyzab
  1983.   ([Aa](miga)?)(-*)500             Amiga-500                   500
  1984.   ([Aa](miga)?)(-*)500             Aa-500                      A
  1985.   ([Aa](miga)?)(-*)500             A-500                       miga
  1986.   ab*bc                            abbbbc                      ac
  1987.   ab*bc                            abc                         axbbc
  1988.   ab+bc                            abbc                        abc
  1989.   ab+bc                            abbbbbc                     abq
  1990.   ab?bc                            abbc                        abbbc
  1991.   ab?bc                            abc                         ac
  1992.   ^abc$                            abc                         abcc
  1993.   ^abc                             abcc                        aabc
  1994.   abc$                             aabc                        abca
  1995.   a.c                              abc                         abb
  1996.   a.c                              axc                         ac
  1997.   a.*c                             axyzc                       axyzd
  1998.   ^a(bc+|b[eh])g|.h$               abh                         abcf
  1999.   (bc+d$|ef*g.|h?i(j|k))           effgz                       zzz
  2000.  
  2001.  
  2002.  
  2003. o Error-Messages (#13)
  2004.   --------------
  2005.  
  2006.   Error-Messages and WARNINGS appear on Standard-Output (stdout). If "Arn"
  2007.   is installed properly and you have some experience with it (it is running
  2008.   stable), you can redirect stdout to NIL:.
  2009.   If "Arn" cannot write its error-messages to its own screen (esp. during
  2010.   startup), it will send them to stdout. So do not redirect stdout to NIL:
  2011.   until you're sure that everything is ok. If the "Arn"-Window is open,
  2012.   you can read all other messages on this window, too.
  2013.  
  2014.   A "STRANGE ERROR" is an unexpected error that should(!) never occur.
  2015.  
  2016.   I hope that you'll never see any of them, but here they are:
  2017.  
  2018.   FATAL ERROR: Can't find/open intuition.library!
  2019.   FATAL ERROR: Can't open my screen!
  2020.   FATAL ERROR: Can't open my window!
  2021.   FATAL ERROR: Can't open a MsgPort!
  2022.   FATAL ERROR: Can't open the Timer!
  2023.   FATAL ERROR: Cannot continue!
  2024.   STRANGE ERROR: Something strange happened...!
  2025.   ERROR: Can't get my config-file, please check it!
  2026.   ERROR: UUConfig - required entry missing or file not found!
  2027.   ERROR: During startup!
  2028.   ERROR: No SEQFILE?!
  2029.   FATAL ERROR: Can't get enough memory!
  2030.   ERROR: Can't find the NEWSDIR!
  2031.   No spooldir available for <...>
  2032.   ERROR: Cannot open GroupList: <...>!
  2033.   ERROR: regexp: <...>
  2034.   ERROR: Can't find the ACTIVEFILE!
  2035.   ERROR: Invalid entry in GROUPLIST!
  2036.   WARNING: No NULL:-device mounted! Machine can crash if you close the CLI!
  2037.   WARNING: No 'uux' entry found! Took 'uux'.
  2038.   WARNING: No 'sendmail' entry found! Took 'sendmail'.
  2039.   WARNING: QuoteChar entry too long!
  2040.   WARNING: TimeZoneName missing or >5 chars, took GMT instead
  2041.   WARNING: GMT-Offset is in wrong format!
  2042.   ERROR: Wrong DBase-Format - missing From:! <...>
  2043.   ERROR: Wrong DBase-Format - missing Subject:! <...>
  2044.   ERROR: DBase-format corrupt: <...>
  2045.   WARNING: Video-Mode not available!
  2046.   WARNING: Headerbuffer is corrupt! <...>    (See below)
  2047.  
  2048.  
  2049. Nevertheless enjoy,
  2050.  Roland
  2051.  
  2052. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2053. (#14)
  2054.                 Changes and new features with this release
  2055.                 ------------------------------------------
  2056.  
  2057. + means new feature, - means changes, bug-fixes.
  2058.  
  2059. Version:                Bugs,Bug-Fixes,Enhancements:
  2060.  
  2061. Arn V1.00 alpha rel3  - The signature is now included always before
  2062.                         the editor is invoked.
  2063.  
  2064.                       - The HEADERBUFFER CORRUPT message will only
  2065.                         appear once on stdout. Please send a report
  2066.                         if you got this error and READ the KNOWN BUGS
  2067.                         section in the Arn.doc before.
  2068.  
  2069.                       - If all groups were read, pressing A showed _no_
  2070.                         groups/all groups. This should be fixed now.
  2071.  
  2072.                       - Q returned to group-dir if you read an article
  2073.                         with ENTER.
  2074.  
  2075. KNOWN BUGS: If Header-Stop-Mode is turned off when it's on and you're at the
  2076.             header, Arn will prompt 'more' to soon.
  2077.  
  2078.             Sometimes I got corrupted headers. You should see the message
  2079.             WARNING: Headerbuffer is corrupt! <...>
  2080.             on stdout.
  2081.             Please send me a mail if you got this error, describe exactly
  2082.             the additional information <...> (e.g. "More!" or "ConClear")
  2083.             AND write your configuration (esp. whether you're using
  2084.             WShell2.0,ConMan,OS2.0/1.3). This bug is not caused by Arn, but
  2085.             by the CMD_CLEAR console command.
  2086.  
  2087. --
  2088.        "Arn" has an "Init and shutdown count", if it crashes during that
  2089.        phase, please report the number.
  2090.  
  2091. Send any (detailed*) BUG-REPORTS to bugs@spirits.ka.sub.org, thanks.
  2092.  
  2093. *Detailed: Write which UUCP-Package you are using, whether you are
  2094.            "scanning" your news or using an active-file. Describe at which
  2095.            level and function the bug occured and which Arn version
  2096.            ("Arn -i") you possess.
  2097.  
  2098. E-Mail Addresses:
  2099. You can reach me at my site 'spirits' or at various other sites.
  2100. ---------------------------------------------------------------
  2101. UUCP/USENET: rob@spirits.ka.sub.org
  2102. or         : S_BLESS@iravcl.ira.uka.de
  2103. BITNET     : UKG5@DKAUNI2.BITNET
  2104. X-400      : UKG5@ibm3090.rz.uni-karlsruhe.de
  2105.              S=UKG5;OU=ibm3090;OU=rz;P=uni-karlsruhe;A=dbp;C=de
  2106. ---------------------------------------------------------------
  2107. Home, sweet home :-):
  2108. Roland Bless, Moersenbroicher Weg 151, Duesseldorf - FRG,
  2109. voice +49 211 623817, FAX: +49 211 623818
  2110.  
  2111. ------------------------e-n-d--o-f--m-a-n-u-a-l---------------------
  2112.